home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / bench / x.txt / 000247_fdc@columbia.edu_Sat Dec 15 13:21:53 EST 2001.msg < prev    next >
Text File  |  2020-01-01  |  3KB  |  61 lines
  1. Article: 13072 of comp.protocols.kermit.misc
  2. Path: newsmaster.cc.columbia.edu!news.columbia.edu!news-not-for-mail
  3. From: fdc@columbia.edu (Frank da Cruz)
  4. Newsgroups: comp.protocols.kermit.misc
  5. Subject: Re: C-Kermit 8.0 files/installation?
  6. Date: 15 Dec 2001 13:20:53 -0500
  7. Organization: Columbia University
  8. Lines: 44
  9. Message-ID: <9vg4a5$mc0$1@watsol.cc.columbia.edu>
  10. References: <9vb3i1$989$1@watsol.cc.columbia.edu> <N%LS7.255$fb1.172478@news.uswest.net>
  11. NNTP-Posting-Host: watsol.cc.columbia.edu
  12. X-Trace: newsmaster.cc.columbia.edu 1008440454 20605 128.59.39.139 (15 Dec 2001 18:20:54 GMT)
  13. X-Complaints-To: postmaster@columbia.edu
  14. NNTP-Posting-Date: 15 Dec 2001 18:20:54 GMT
  15. Xref: newsmaster.cc.columbia.edu comp.protocols.kermit.misc:13072
  16.  
  17. In article <N%LS7.255$fb1.172478@news.uswest.net>,
  18.  <robert@bonomi.invalid> wrote:
  19. : Comment: Documentation in HTML is nice, "pretty", makes it easy to cross-
  20. :          reference things.  All good reasons for using it.  
  21. : 
  22. :      *HOWEVER*, please don't make it the _only_ form that things are 
  23. :      available in!  Sometimes a web-browser is *NOT* 'conveniently
  24. :      available'.  "Plain text" is *universally* readable with simple
  25. :      tools, and can be much faster to use to find specific info. e.g.,
  26. :      vi and a '/' search, will have the job done, _before_ a browser
  27. :      finishes initializing itself.
  28. :
  29. All of that should go without saying.  The text files that were converted
  30. to html are also all dumped back out as text.  We didn't convert to html
  31. because it was pretty, we did it so we could link to specific sections of
  32. specific documents in tech-support e-mail and newsgroup postings, so people
  33. could click on the links and get the info immediately and directly.
  34.  
  35. : As an alternative, consider what Hylafax does -- it provides for
  36. : customizations in the Makefile as for where to install the configuration
  37. : files and secondary documentation. the makefile target for installing the
  38. : manpages includes editing to indicate the _actual_ locations on the
  39. : installed system.
  40. :
  41. The new makefile announced yesterday does this with "make install":
  42.  
  43.   ftp://kermit.columbia.edu/kermit/test/text/makefile
  44.  
  45. : This is indicative of a 'documentation failure', not a flaw in the approach.
  46. : And much easier to remedy.  Appropriate language in the release announcement
  47. : and the  'download' web-page -- e.g. "downloading the Supplement is _not_
  48. : necessary for a working Kermit installation"
  49. : 
  50. See what you think about the wording here:
  51.  
  52.   http://www.columbia.edu/kermit/ckuins.html#x5
  53.  
  54. : Suggest, despite your prior 'confusion' experience, multiple tarballs.
  55. : 
  56. Done:
  57.  
  58.   http://www.columbia.edu/kermit/ckuins.html#x1
  59.  
  60. - Frank
  61.